<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>Manage subscribeable mailing lists</title>
        <link rel="stylesheet" type="text/css" href="./css/markdown.css" />
    </head>
    <body>

    <div id="navigation">
    <a href="https://www.iredmail.org" target="_blank">
        <img alt="iRedMail web site"
             src="./images/logo-iredmail.png"
             style="vertical-align: middle; height: 30px;"
             />&nbsp;
        <span>iRedMail</span>
    </a>
    &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="manage-subscribeable-mailing-lists">Manage subscribeable mailing lists</h1>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<p>Check out the lightweight on-premises email archiving software developed by iRedMail team: <a href="https://spiderd.io/">Spider Email Archiver</a>.</p>
</div>
<div class="toc">
<ul>
<li><a href="#manage-subscribeable-mailing-lists">Manage subscribeable mailing lists</a><ul>
<li><a href="#summary">Summary</a></li>
<li><a href="#manage-subscribeable-mailing-lists-with-iredadmin-pro">Manage subscribeable mailing lists with iRedAdmin-Pro</a></li>
<li><a href="#manage-subscribeable-mailing-lists-with-command-line-tool">Manage subscribeable mailing lists with command line tool</a></li>
<li><a href="#references">References</a></li>
<li><a href="#see-also">See Also</a></li>
</ul>
</li>
</ul>
</div>
<h2 id="summary">Summary</h2>
<p>Since iRedMail-0.9.8, iRedMail integrates mlmmj as mailing list manager.</p>
<h2 id="manage-subscribeable-mailing-lists-with-iredadmin-pro">Manage subscribeable mailing lists with iRedAdmin-Pro</h2>
<p>With <a href="https://www.iredmail.org/admin_panel.html">iRedAdmin-Pro</a>, you can easily
manage mailing list accounts with its web UI. Screenshots of mailing
list profile pages in iRedAdmin-Pro:</p>
<p>Profile page:</p>
<p><img alt="" src="./images/iredadmin/mailinglist_profile.png" width="900px" /></p>
<p>Allow users to subscribe from web page:</p>
<p><img alt="" src="./images/iredadmin/mailinglist_newsletter.png" width="900px" /></p>
<p>Instruction to generate a newsletter sign up form:</p>
<p><img alt="" src="./images/iredadmin/mailinglist_signup_code.png" width="900px" /></p>
<h2 id="manage-subscribeable-mailing-lists-with-command-line-tool">Manage subscribeable mailing lists with command line tool</h2>
<p>iRedMail integrates <a href="https://github.com/iredmail/mlmmjadmin"><code>mlmmjadmin</code></a> (a
RESTful API server developed by iRedMail team) to help you manage mlmmj mailing
lists, it also offers command line script
<code>/opt/mlmmjadmin/tools/maillist_admin.py</code> for system administrators.</p>
<div class="admonition attention">
<p class="admonition-title">Attention</p>
<ul>
<li>All settings used to create or update mailing list profiles are listed on
  <a href="https://github.com/iredmail/mlmmjadmin/blob/master/docs/API.md">mlmmjadmin API document</a>.</li>
<li>Since mlmmjadmin-3.0, it requires Python 3.</li>
</ul>
</div>
<p>Available commands:</p>
<ul>
<li><code>create</code>: Create a new mailing list account with additional setting:</li>
<li><code>info</code>: Show settings of an existing mailing list account</li>
<li><code>update</code>: Update an existing mailing list account</li>
<li><code>delete</code>: Delete an existing mailing list account</li>
<li><code>subscribers</code>: Show all subscribers</li>
<li><code>has_subscriber</code>: Check whether mailing list has given subscriber.</li>
<li><code>subscribed</code>: Show all subscribed lists of a given subscriber.</li>
<li><code>add_subscribers</code>: Add new subscribers to mailing list.</li>
<li><code>remove_subscribers</code>: Remove existing subscribers from mailing list.</li>
</ul>
<p>Examples:</p>
<ul>
<li>Create a new mailing list account with additional setting:</li>
</ul>
<p><code>python3 maillist_admin.py create list@domain.com only_subscriber_can_post=yes disable_archive=no</code></p>
<ul>
<li>Get settings of an existing mailing list account</li>
</ul>
<p><code>python3 maillist_admin.py info list@domain.com</code></p>
<ul>
<li>Update an existing mailing list account</li>
</ul>
<p><code>python3 maillist_admin.py update list@domain.com only_moderator_can_post=yes disable_subscription=yes</code></p>
<ul>
<li>Delete an existing mailing list account</li>
</ul>
<p><code>python3 maillist_admin.py delete list@domain.com archive=yes</code></p>
<ul>
<li>Add new subscribers <code>user1@gmail.com</code> and <code>user2@hotmail.com</code>:</li>
</ul>
<pre><code>python3 maillist_admin.py add_subscribers list@domain.com user1@gmail.com user2@hotmail.com
</code></pre>
<ul>
<li>List all subscribers:</li>
</ul>
<p><code>python3 maillist_admin.py subscribers list@domain.com</code></p>
<ul>
<li>Show subscribed lists of a given subscriber:</li>
</ul>
<p><code>python3 maillist_admin.py subscribed subscriber@domain.com</code></p>
<ul>
<li>Check whether mailing list has given subscriber:</li>
</ul>
<p><code>python3 maillist_admin.py has_subscriber list@domain.com subscriber@gmail.com</code></p>
<h2 id="references">References</h2>
<ul>
<li>Mlmmj:<ul>
<li><a href="http://mlmmj.org/">web site</a></li>
<li><a href="http://mlmmj.org/docs/tunables/">Tunable parameters</a></li>
<li><a href="http://mlmmj.org/docs/readme-postfix/">Postfix integration</a></li>
</ul>
</li>
<li><a href="https://github.com/iredmail/mlmmjadmin">mlmmjadmin</a>: RESTful API server used to manage mlmmj mailing lists. Developed
  and maintained by iRedMail team.</li>
</ul>
<h2 id="see-also">See Also</h2>
<ul>
<li><a href="./integration.mlmmj.ldap.html">Integrate mlmmj mailing list manager in iRedMail (OpenLDAP backend)</a></li>
<li><a href="./integration.mlmmj.mysql.html">Integrate mlmmj mailing list manager in iRedMail (MySQL/MariaDB backends)</a></li>
<li><a href="./integration.mlmmj.pgsql.html">Integrate mlmmj mailing list manager in iRedMail (PostgreSQL backend)</a></li>
</ul><div class="footer">
    <p style="text-align: center; color: grey;">All documents are available in <a href="https://github.com/iredmail/docs/">GitHub repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</a> license. You can <a href="https://github.com/iredmail/docs/archive/master.zip">download the latest version</a> for offline reading. If you found something wrong, please do <a href="https://www.iredmail.org/contact.html">contact us</a> to fix it.</p>
</div></body></html>